home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
tex
/
dvivga1.zip
/
DVIVGA.DOC
next >
Wrap
Text File
|
1988-10-22
|
16KB
|
398 lines
DVIVGA
Public Domain DVI Previewer for the IBM PC
Doug McDonald
<mcdonald@uiucuxe.bitnet> | <mcdonald@uxe.cso.uiuc.edu>
DVIVGA is a TeX screen previewer for the IBM PC. It expects the name of
the .DVI file on the command line, and the extension .dvi can always
be omitted. As illustrated below, it issues a one-line identifier
message and, if no command line arguments are given, type a UNIX-style
message.
This driver and the associated font files are public domain. It is part
of a family written by Nelson Beebe of the University of Utah and
others. The screen previewer is an adaptation of this code by Doug
McDonald at the University of Illinois.
EQUIPMENT REQUIREMENTS
An IBM PC computer with 512K or more of memory. Alternately, a
compatible with similar specs. The screen driver needs an EGA, VGA or
MCGA graphics adapter, or a clone. A clock speed of 8MHz minimum is
essentially necessary, unless you are a very patient person. A 20 or
25MHz machine is fast enough that you will be very happy. A fast hard
disk is also necessary.
This program will work on computers with EGAs. However, and it is a big
however, the pixels on an EGA are not square. Hence the output will be
distorted: circles come out as vertically stretched ellipses, squares
as vertically stretched rectangles, and text is a bit too high.
Nevertheless, it doesn't look bad at all and is useful.
OPTIONS
The order of command options and .DVI file name is not significant; all
switch values are accepted by this driver, but not all are really
meaningful.
Letter case is ignored in option switches: -A and -a are equivalent.
-a Implement virtual font caching. This option is
essentially useless for this driver.
-d Produce debugging output on stderr if a non-zero
value is given. These are:
2 --- Display coordinates, metrics, and bitmap
of each character.
8 --- Display each successful file opening.
16 --- Display each unsuccessful file opening.
32 --- Show discarded off-page text.
64 --- Trace virtual font caching.
128 --- Trace character setting.
It is possible to combine these options by adding
their values.
-eVAR=value Define environment variables on command line. This
is an alternative to placing them in the DOS
environment.
-ffontsubfile Define an alternate font substitution file which is
to be used instead of the default ones (see below).
-l Inhibit logging.
-m Reset magnification. The default for the screen
(k/2)
driver is -m502. Useful values are int(1500*1.2 )
from 279 to 1500. Other values will be reset to the
nearest value in this set. Magnification values less
than 25 are taken to be a TeX magstep parameter
which is applied to the standard magnification for
that device. Thus -m-0.5 will reduce the output size
by the square root of 1.2, -m2 will increase it by
a factor of 1.44.
You may well need to use this parameter frequently;
good values to try are 603, 502, 459, 419, 382,
349, 318, and 289. These are equivalent to -m0.5,
-m-0.5, -m-1, ... -m-3.5. -m382 or -m-2 gives actual
size output using VGA on an IBM8513 monitor.
Sizes smaller than 459 use substitute fonts, so that
they may not come out looking quite perfect.
Read about "Batch Files" to find an easy way of
changing sizes.
-q Quiet mode. Status displays to screen are
suppressed, unless warning or error messages are
issued. This switch is a toggle. The default is
not to display messages.
-x#units The -x options specify the left margin of the TeX
page on the output page in any of several units.
Letter case is not significant in the units field,
which must not be separated from the number by any
space. The number may be fractional. For example,
-x1.0in, -x2.54cm, -x72.27pt, and -x6.0225pc all
specify a one-inch left margin. Negative values are
permissible, and may be used to shift the output
page left (possibly truncating it on the left) in
order to display a wide TeX page.
The units field is mandatory, and may be one of
big point (1in = 72bp)
cicero (1cc = 12dd)
centimeter (1in = 2.54cm)
didot point (1157dd = 1238pt)
inch
millimeter (10mm = 1cm)
pica (1pc = 12pt)
point (72.27pt = 1in)
scaled point (65536sp = 1pt)
-y#units This is just like -x except that it is for the top
margin.
Because the normal defaults waste screen space, the
defaults for the screen driver have both been set to
zero. If you wish to get the correct margins and
size, try -x1.in -y1.in -m382 for DVIVGA.
FONT SUBSTITUTION
If no -ffontsubfile option is given, and font substitution is required,
if the current .DVI file is foo.dvi, then the files foo.sub,
texfonts.sub, and TEXINPUTS\texfonts.sub will be tried in order. The
first two will be found on the current directory, and the last is the
default given in the environment string TEXINPUTS. The -f option
allows all of these to be overridden. It is essentially necessary to
have this file if you use a magnification smaller than the default for
DVIVGA. A copy of a suitable one is supplied.
Font substitution lines have the form:
oldname.oldmag subname.submag % comment
oldname oldmag subname submag % comment
oldname subname % comment
Examples are:
----------
% These provide replacements for some LaTeX invisible fonts:
icmr10 1500 -> cmr10 1500 % comment
icmr10.1500 -> cmr10.1500 % comment
icmssb8 -> cmssb8 % comment
----------
The first two forms request substitution of a particular font and
magnification. The third form substitutes an entire font family; the
closest available magnification to the required one will be used. Any
dots in the non-comment portion will be converted to spaces, and
therefore, cannot be part of a name field.
The first matching substitution will be selected, so
magnification-specific substitutions should be given first, before
family substitutions.
Comments are introduced by percent and continue to end-of-line, just as
for TeX. One whitespace character is equivalent to any amount of
whitespace. Whitespace and comments are optional.
SCREEN CONTROL
DVIVGA supports interactive viewing of the TeX output. Here is the
current command list. Input is immediate; no terminating carriage
return is necessary, except for the number command to go to a
particular page.
uparrow downarrow Move the view of the current page up or down. These
commands do not require recalculating the screen